
 *-commands
 ==========
 The HBP10GM MIDI synthesizer module provides a number of *-commands
 for configuring and setting up the synth.


 Notice that notes, program bank numbers, program numbers etc. are
 numbered from 1 and up in patchfiles and when using *-commands; when
 using SWIs and in MIDI events, they are numbered from 0 and up.


 *HBP10GM_Config <name> <value>
  Configures HBP10GM.
  Name         Value
  FREQ         preferred playback frequency
  POLY         max. polyphony (16..64)
  DRUM         set which channel to use as drum-channel; all other
               channel will be set to not be drum-channels; normally,
               channel 10 is the drum-channel
  VOLUME       master-volume (0..4096, 4096=0dB, 2048=-6dB, 1024=-12dB)
  TUNING       master-tuning (-24..24 semitones)
  INTERPOLATE  0 (disable) or 1 (enable)
  BASECHANNEL  channel to use when in Omni Off/Poly mode

  Enabling sample interpolation (*HBP10GM_Config INTERPOLATE 1)
  improves the sound quality but also uses a bit more CPU; try using
  the supplied program 'ReadData' to read samples with and without
  interpolation, and then compare the results in a sample editor...
  *HBP10GM_Config without any arguments displays the configuration.


 *HBP10GM_RealTime [<drivername>]
  Enables (or disables) realtime output from the synthesizer. This
  means that data can be output from applications (eg. MIDI-players)
  in non-realtime (as it is buffered by some kind of scheduler), but
  the output from the HBP10GM must be read in realtime; if no driver
  is specified, realtime output is disabled.

  drivername
  MIDISUPPORT    attempts to install the HBP10GM as a MIDI-device
                 under MIDISupport; use SWI MIDI_TxCommand or
                 similar to feed MIDI-events to the synth
  100Hz          installs a timer that calls SWI HBP10GM_Ticker,2
                 100 times/second; use SWI HBP10GM_Schedule to
                 feed MIDI-events to the HBP10GM
  MIDI500        attempts to install the synth as a MIDI-device under
                 the free MIDI500 module; use SWI MIDI_TxCommand or
                 similar to feed MIDI-events to the synth

  If you're using either MIDI500 or MIDISUPPORT, but the driver fails
  to install, it will remain dormant and will attempt to reinstall when
  the MIDI module is initialised.

  Use '*HBP10GM_RealTime ?' to see which is the selected driver.


 *HBP10GM_LoadPatches <file> <bank>
  Loads a patch-file.
  <file>      name of patch-file
  <bank>      program bank to load the patches into (1..16)


 *HBP10GM_Playback [0 | 1]
  Starts/stops playback through the Acorn 16 bit sound card.
  *HBP10GM_Playback 0            stop
  *HBP10GM_Playback 1            start


 *HBP10GM_Patches [<bank>]
  Lists the named patches in either a single bank or in all
  banks.
